home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.n / update.n < prev    next >
Text File  |  1995-07-25  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4.      uuuuppppddddaaaatttteeee((((nnnn))))                    TTTTkkkk (((( ))))                     uuuuppppddddaaaatttteeee((((nnnn))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           update - Process pending events and/or when-idle handlers     |
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS                                                           ||||
  14.           uuuuppppddddaaaatttteeee ?iiiiddddlllleeeettttaaaasssskkkkssss?
  15.      _________________________________________________________________
  16.  
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           This command is used to bring the entire  application  world
  20.           ``up  to  date.''  It  flushes  all  pending  output  to the
  21.           display,  waits for the server to process  that  output  and
  22.           return  errors  or events, handles all pending events of any
  23.           sort (including when-idle handlers), and repeats this set of
  24.           operations  until  there  are  no pending events, no pending
  25.           when-idle handlers, no pending output to the server, and  no
  26.           operations still outstanding at the server.
  27.  
  28.           If the iiiiddddlllleeeettttaaaasssskkkkssss keyword is specified as an argument to  the  |
  29.           command,  then  no new events or errors are processed;  only  |
  30.           when-idle idlers are invoked.  This causes  operations  that  |
  31.           are  normally  deferred,  such as display updates and window  |
  32.           layout calculations, to be performed immediately.             |
  33.  
  34.           The uuuuppppddddaaaatttteeee iiiiddddlllleeeettttaaaasssskkkkssss command  is  useful  in  scripts  where  |
  35.           changes  have  been  made to the application's state and you  |
  36.           want those changes to appear  on  the  display  immediately,  |
  37.           rather  than waiting for the script to complete.  The uuuuppppddddaaaatttteeee  |
  38.           command with no options is useful in scripts where  you  are  |
  39.           performing a long-running computation but you still want the  |
  40.           application  to  respond  to  user  interactions;   if   you  |
  41.           occasionally  call  uuuuppppddddaaaatttteeee then user input will be processed  |
  42.           during the next call to uuuuppppddddaaaatttteeee.
  43.  
  44.  
  45.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  46.           event, flush, handler, idle, update
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.